home *** CD-ROM | disk | FTP | other *** search
/ L' Effet Pommier 3 / L'Effet Pommier - Volume 03.iso / Programmation / Tcl⁄Tk Folder / README-mac-tcl < prev    next >
Encoding:
Text File  |  1996-02-01  |  7.0 KB  |  200 lines  |  [TEXT/ALFA]
  1. Macintosh Tcl
  2.  
  3. by Ray Johnson
  4. Sun Microsystems Laboratories
  5. rjohnson@eng.sun.com
  6.  
  7. @(#) README 1.9 96/01/30 11:13:01
  8.  
  9. 1. Introduction
  10. ---------------
  11.  
  12. This is the README file for the Macintosh version of the Tcl
  13. scripting language.  The file consists of information specific
  14. to the Macintosh version of Tcl.  For more general information
  15. please read the README file in the main Tcl directory.
  16.  
  17. 2. What's new?
  18. --------------
  19.  
  20. A great deal of changes have been made to Tcl since the last 
  21. alpha release.  Many of these are mentioned in the general
  22. README about Tcl, I'll focus on those relating to the Macintosh
  23. version of Tcl.
  24.  
  25. Path names - The way path names are handled is very different.  The
  26.     old method had several draw backs (including not being able 
  27.      to access certain files.)  There are two methods for
  28.     specifing a path.  The first is a native path.  The native
  29.     path uses colons ':' as separaters - it's format  is
  30.         documented in "Inside Macintosh" and is used in applications
  31.     like MPW.  The second method is what we call a "network"
  32.     path.  It's format is a superset of Unix style paths.  Use
  33.     network paths if you write scripts that need to be cross
  34.     platform.
  35.  
  36. Sockets - Sockets have now been added to the core Tcl.  Unfortunantly,
  37.     this code is largely untested.  I have used the "client"
  38.     side of this code with some success.  Please, report any
  39.     problems you have.  However, I have a feeling it will take me
  40.     a while to work out all the bugs.
  41.     
  42. New file I/O - The file I/O subsystem has been completely rewritten.
  43.     The next step will be to provide for non-blocking I/O with
  44.     files.  This will hopefully be available before we go final.
  45.     One benifit of the rewrite is better handling of aliases in
  46.     file or directory paths.  (You can now make the libraries in
  47.     the extensions folder an alias to some other location.)
  48.  
  49. 3. The Distribution
  50. -------------------
  51.  
  52. Macintosh Tcl is distributed in three different forms.  This 
  53. should make it easier to only download what you need.  The 
  54. packages are as follows:
  55.  
  56. mactk4.1b1.sea.hqx
  57.  
  58.     This distribution is a "binary" only release.  It contains an
  59.     installer program that will install a 68k, PowerPC, or Fat
  60.     version of the "Tcl Shell" and "Wish" applications.  In addition,
  61.     it installs the Tcl & Tk libraries in the Extensions folder inside
  62.     your System Folder.  (These are just text files - no inits are
  63.     installed.)
  64.  
  65. mactcltk-full-4.1b1.sea.hqx
  66.  
  67.     This release contains the full release of Tcl and Tk for the
  68.     Macintosh plus the GUSI and More Files packages which both
  69.     Macintosh Tcl and Tk rely on.
  70.  
  71. mactcl-source-7.5b1.sea.hqx
  72.  
  73.     This release contains the complete source for Tcl 7.5.  In
  74.     addition, Metrowerks CodeWarrior libraries and project files
  75.     are included.  However, you must already have the More Files and
  76.     GUSI packages to compile this code.
  77.  
  78. 4. Documentation
  79. ----------------
  80.  
  81. The "doc" subdirectory contains reference in documentation in
  82. in the "man" format found on most UNIX machines.  Unfortunantly,
  83. there is not a suitable way to view these pages on the Macintosh.  
  84. A version suitable for viewing on the Macintosh has yet to be
  85. developed.  We are working are having better documentation for
  86. the Macintosh platform in the future.  However, if you have WWW 
  87. access you may access the Man pages at the following URL:
  88.  
  89.     http://www.smli.com/research/tcl/man/
  90.  
  91. Other documentation and sample Tcl scripts can be found at
  92. the Tcl ftp site: 
  93.  
  94.     ftp://ftp.aud.alcatel.com/tcl/
  95.  
  96. The internet news group comp.lang.tcl is also a valuable
  97. source of information about Tcl.  A mailing list is also
  98. available (see below).
  99.  
  100. 5. Compiling Tcl
  101. ----------------
  102.  
  103. In order to compile Macintosh Tcl you must have the 
  104. following items:
  105.  
  106.     CodeWarrior Release 7 or higher
  107.     Mac Tcl 7.5 (source)
  108.     CWGUSI 1.6.4 or higher
  109.     More Files 1.4.1
  110.  
  111. The project  files included with the Mac Tcl source should work 
  112. fine.  The only thing you may need to update are the access paths.
  113.  
  114. 6. Test suite
  115. -------------
  116.  
  117. The Macintosh version of Tcl passes most all tests in the Tcl
  118. test suite.  The only exceptions are the tests in file.test
  119. which still use exec.  Slower Macs will also fail a test in 
  120. event.test whose timing constraints are too tight.  If other
  121. tests fail please report them.  This will help make Tcl a more
  122. robust language on the Macintosh platform.
  123.  
  124. 7. Environment Variables
  125. ------------------------
  126.  
  127. Environment variables may be added to the system via three different 
  128. mechanisms. The first is automatic inclusion of system variables.  These 
  129. variables include things like the system folder path.  These variables are 
  130. determined at startup time (for the interpreter) but are not changed if 
  131. the system changes.  The following environment variables are created via 
  132. this method:
  133.     
  134.     LOGIN - holds the Chooser name of the Macintosh
  135.     USER - also holds the Chooser name of the Macintosh
  136.     SYS_FOLDER - path to the system directory
  137.     APPLE_M_FOLDER - path to the Apple Menu directory
  138.     CP_FOLDER - path to the control panels directory
  139.     DESK_FOLDER - path to the desk top directory
  140.     EXT_FOLDER - path to the system extensions directory
  141.     PREF_FOLDER - path to the preferences directory
  142.     PRINT_MON_FOLDER - path to the print monitor directory
  143.     SHARED_TRASH_FOLDER - path to the network trash directory
  144.     TRASH_FOLDER - path to the trash directory
  145.     START_UP_FOLDER - path to the start up directory
  146.     PWD - path to the application's default directory
  147.  
  148. Environment variables may also be placed in a file.  A file named 
  149. "Tcl Environment Variables" may be placed in the preferences folder.  
  150. Each line of this file should be of the form "VAR_NAME=var_data".
  151.     
  152. For example,
  153.  
  154.     PRINTER=Joe's LW
  155.     TCLLIBPATH=Lozoya:System Folder:Tcl Lib
  156.  
  157. The last alternative is to place environment variables in a 'STR#' 
  158. resource named "Tcl Environment Variables" of the application.  This is 
  159. considered a little more "Mac like" than a Unix style Environment
  160. Variable file.  Each entry in the 'STR#' resource has the same format
  161. as above.  The source code file "tclMacEnv.c" contains the
  162. implementation of the env mechanisms.  This file contains many
  163. #define's that allow customization of the env mechanisms to fit your
  164. applications needs.
  165.  
  166. 8. Macintosh Tcl Mailing List
  167. -----------------------------
  168.  
  169. A Mailing List has been set up to discuss Macintosh related Tcl issues
  170. including (but not limited to) MacTcl.  In order to use this Mailing
  171. List you must have access to the internet.  If you have access to the
  172. WWW the home page for this mailing list is located at the following
  173. URL:
  174.  
  175.     http://www.smli.com/research/tcl/lists/mactcl-list.html
  176.  
  177. The home page contains information about the list and an HTML archive
  178. of all the past messages on the list.  To subscribe send a message to:
  179.     
  180.     listserv@sunlabs.sun.com
  181.     
  182. In the body of the message (the subject will be ignored) put:
  183.     
  184.     subscribe mactcl Joe Blow
  185.     
  186. Replacing Joe Blow with your real name, of course.  If you would just
  187. like to receive more information about the list without subscribing
  188. but the line:
  189.  
  190.     information mactcl
  191.     
  192. in the body instead.
  193.  
  194.  
  195.  
  196. If you have comments or Bug reports send them to:
  197. Ray Johnson
  198. rjohnson@eng.sun.com
  199.  
  200.